英数字バーコードに対応し、スキャン入力を画面へ渡さないようにする - #53

背景

• バーコードを読ませるとサイドバーが開いてしまう事象があった。MainActivity の dispatchKeyEvent がデコーダにキーを渡したあと必ず super を呼んでいたため、スキャンした数字・英字・Enter が Compose 側にも通常のキー入力として届いていた
• デコーダは keyCode - 7 で数字を作る実装だったため、A01000008A のような先頭英字の10文字形式を扱えなかった
• サーバの商品照会はバーコード形式を ^A(00|01|02)\d{6}A$ で検証するため、旧形式の数字10桁バーコード（例 1001010003）は Invalid barcode format で弾かれていた

変更内容

BarcodeKeyEventDecoder

• keyCode の計算をやめ、KeyEvent の unicodeChar から実際の文字を読み取る
• 数字10桁形式は3〜4文字目、先頭英字形式は2〜3文字目を種別コードとして解釈する
• 小文字で届いた場合は大文字に正規化する
• Shift / Alt / Ctrl は読み取りを中断させず読み飛ばす。Enter は通常の Enter と Numpad Enter の両方を受ける
• 読み取り機の連打とみなせるキー（直前のキーから200ms以内）だけを消費し、消費したキーは ACTION_UP も合わせて消費する。ゆっくり手で打った文字は消費せず画面へ通すため、物理キーボードでの設定画面入力は従来どおり動く
• Enter を消費するのは10文字のバーコードが揃ったときだけ

MainActivity

• デコーダが消費したキーは super.dispatchKeyEvent へ渡さず true を返す

ItemRepository

• 商品照会をキャッシュ優先にした。起動時に取得済みの商品一覧にバーコードが完全一致すればサーバへ問い合わせない。見つからないときだけ従来どおり API を呼ぶ
• これにより、サーバの形式検証に通らない旧形式のバーコードでもキャッシュにあれば読み込める。サーバ側の検証は変更していない

テスト

BarcodeKeyEventDecoderTest を19ケースに拡充

• 数字10桁形式の ITEM / STAFF / SALE / 未定義プレフィックス
• 先頭英字形式（A01000008A など）の ITEM / STAFF / SALE / 未定義プレフィックス
• 小文字入力の大文字正規化
• 文字の間に Shift が挟まっても読み取りが壊れないこと
• 10文字揃わずに Enter が来た場合は何も返さず、バッファがクリアされること
• 読み取り成功後にバッファがクリアされること
• 対象外の文字でバッファがクリアされること
• スキャンした文字が消費され画面へ届かないこと
• Enter はバーコードが読めたときだけ消費されること
• 消費したキーの ACTION_UP も消費されること、触れていないキーの ACTION_UP は消費されないこと
• ゆっくり打った文字は消費されないが読み取り自体は成立すること

ItemRepositoryTest に2ケース追加

• キャッシュに一致する商品があれば API を呼ばずキャッシュの商品を返すこと
• キャッシュに無ければ API にフォールバックすること

残作業

• 実機で数字10桁形式と英数字形式の両方を読み込み、サイドバーが開かないことと商品読込が成功することの確認が必要

Generated by Claude Code